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DEC STANDARD 165 
Standard Foe Documentation Symbology 



Standacds Subcommittee 



This standard defines character 
special key names, and nc 
conventions that are to be used : 
documentation . 



The information in this document is subject to change 
without notice and should not be construed as a 
commitment by Digital Equipment Corporation. Digital 
Equipment Corporation assumes no responsibility for any 
errors that may appear in this document. 



Copyright ©1977 by Digital Equipment C 



-dSDDtO 



DEC STD 165 



INTRODUCTION 



Goals 
ro promote documentation compatibility in the following <. 

1. Character Naming - standard n 
to be used when the chacacte 
attention. 

2. Special Key Representation - standard graphic repri 
of special keys and multiple key combinations; standard 
for these keys and representations. 

3 . Notation Conventions 
notation in command si 
input/output. 

ro define a standard usage of symbols and names t 



3t limited t 

Software Public 
Software Development 
Production Groups 
Software Services 
Educational Services 
Software Quality Management 
Software Product Management 
Technical Publications 



Standardization Effort 
a DEC Standard, this : 
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Standard foe Indexes, Appendixes, Running Heads, and Seel 
Numbering foe Software Documentation Manuals: 
DEC STD 118. 



Standard for Updating Software Kanuals : DEC STD 143. 

Non-Typeset Media: 

Keyboard Standard: DEC STD 107 

ANSI X3. 4-1977 ASCII and DEC STD 051 

ANSI X3.32 Graphic Representation of the Control Character of ASCII 

ISO 646 7-bit coded Character Set 

1.5 Future Standards Activities 

This standard will be updated as needed. 

2.0 CONFORMANCE 

Upon approval of this standard, writing and production groups will 
conform when creating new manuals. No manual already existing should 
be redone simply to conform to this standard. 



If no symbology exist 
introduce symbology, t 
standard. 



3.0 DEFINITION OF THE STANDARD 
The definition of the standard is di\ 
1. Character naming 

3. Notation conventions 
The definition of the standard follov 

SD'L j! . 
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PART I 
CHARACTER NAMING STANDARDS 






iting characters, the n 
r>e international code 
ts action, follow Pact 
: RETURN is the name of 



idard ISO 646. 
Thus Carriage 



Peciod - wh 


en used in any sen: 


se but arithme 


Example: 


In any command s 
type are sepacat 
FILE01.MAC. 


.tiing, filena 


Radix point 
arithmetic 


sense. *" ^ "^ 


non-dec imal n 


Example : 


The octal number : 
an implied radix 


Is expressed a 
5 value' 1.234! 


Decimal poi 


.nf - when used wi 


.th decimal m 



value 3141.00. 



Comma 
Slash 

Colon 
Semicolon 

' Single quotatic 
Example: A c 



:C ? fj;'* tt ' 
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To illustrate a quotation within a 

quotation, enter a left single quotation 

mack, the text, and then a eight single 
quotation mack. 



quotation, entec 
mack, the text, 
quotation mack. 



Apostcophe - when used i 



The possessive cas< 
expressed as pecsor 
an apostcophe and a 



Quotation 


macks 




Example : 


A quotation is enclosed in quotat: 


ion macks. 


Left quotation mack - when used to ceference 
itself. 


: tne mark 


Example : 


To illustcate a quotation, entec 
quotation mack, the text, and 
eight quotation mack. 


the left 


Right quotation mack - when used to cefecence 
itself. 


S the mark 


Example: 


To illustcate a quotation, enter 
quotation mack, ^he text, and 
right quotation mack. 


the left 
then the 


Quotation 
itself. 


mack - when used to ceference 


the mark 


Example : 


To entec litecal text, type a 
mark followed by the text. 


quotation 


Exclamatic 


»n point 




At sign 







i indicated by typing . 
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Number sign 

Dollar sign 

Peccent sign 

Cent sign 

Ampersand 

Asterisk 

Left parenthesis 

Right pacenthesis 

Left square bracket 

Right squace bracket 

Underline 

Hyphen - when used in 

Example: Parameters in the statement < 
by hyphens; e.g., CALL argl-a 

Minus sign - when used in an arithmetic sense. 

> sign in a statement implie 

on is to be performed; e.g. 

'argl-arg2' implies that the value of arg 

is to be subtracted from the value of acgl 



En dash 
Plus sign 

Not-equal sign 
Left brace 
Right brace 
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Down-arcow 






Left angle bracket - when u 

Example: In RUNOFF, a wocd p 
bracket is pcinted 
e.g. , <dec is print 

Less-than sign - when used in ai 

Example: Inequality can be 

means that the vali 
the value of arg2. 

Right angle bracket - when i 
arithmetic. 



; less than 



Example: In RSX-11D, the right angle bracket is 
typed as a prompt to indicate that the 
system is ready _o receive typed input; 
e.g., the typeo it x_R> indicates thac MCR 
input can be typea. 

Great^r-than sign - when used in an arithmetic sense. 

Example: Inequality can be expressed using the 
greater-than sign; e.g., the term arg2>argl 
means that the value of arg2 is greater 
than the value jf argl. 

jreater-than-or-equal sign 

Less-than-or -equal sign 

Backslash 

Vertical line 

Tilde 

Pound sign (English currency) 

Lozenge 

Currency symbol (International) 
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PART II 
KEY (FUNCTION) NAMING STANDARDS 



This pact pcovides the appcopciate symbol to indicate that a 
particular terminal key is to be pressed. These symbols are mainly 
used in commar-" line descriptions and examples. The symbols in this 
part have been chosen to correspond to the ch=" -cters found on the 
keys. Thecefore, these symbols conform to the DEC Keyboard Standard 
(DEC STD 107) in preference to ISO 646-1973 or ANSI X3. 4-1977. 

These symbols ace to be used in printed manuals. In documents where 

these symbols are not feasible (e.g., drafts, functional specs), these 

symbols are to be enclosed in angle brackets instead of being 
contained in an oval. 

SYMBOL FOR SYMBOL FOR MEANING 
USE IN PRINTED USE IN AND 
KEY MANUALS DRAFTS EXAMPLE 



Whecever possible, use of the 
RETURN key should be implied 
rather than expressed. For 
example, it is advisable 



! FEED GO 



When the LINE FEED key mus 
be pressed, use the symbol t 
denote the fact. 



INSERT ARG1GOARG2 

Whenevec the CTRL key and 
anothec key must be pcessed 
at the same time, denote the 
combination as CTRL/x. 

Example : At the end of the 
input text, entec a CTRL/Z to 
indicate the end-of-file. 
Foe example: 



sosddm 
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SO?.BD^ 



When the TAI 

denote the 1 
delimit the symbol 
spaces unless they ace 
to be entered as spaces. 



Do 



When the RQBOUT oc DELETE 
key must be pressed, use the 
symbol to denote the fact. 
However , do not use the 
symbol when showing actual 
echoed output at the 
1. 



RNU\UN\UN. 
When the ESC o 



SHIFT key and 

ime , denote the 
; SHFT/x. 
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Wherever possible, i 
SPACE key should t 

need arises to ind: 


ase of the 
le implied 
:ed. If a 


the symbol to del 


:ered, use 



Whenever the VT Key must 
pressed, use the symbol 
denote the fact. 



m m 
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NOTATION CONVENTIONS STANDARDS 



This pact i 


llustrates the symbols to 




ms ace required, variable 


user . in 


addition, this section 


between uset 


: input and machine output 



i command line when 
c a choice of the 
w to differentiate 



Chacactecs enclosed in these special square bcacket 
indicate optional information that can be omitted from 
command string without affecting the basic meaning. Thes 
special bcackets are chosen to avoid confusion with tr. 
standard ASCII characters [ and ] . When these symbols ar 
used to denote options, the corresponding default option 
must be described in accompanying text. 

Example: .R SOS-file. typ [|/NOBAk| 



!D? 



This symbol is 


5 to 


be used ir 


> pr inted 


documents where 




symbol is no 




functional spec: 








typing an upper- 


-case 


I over a bracket. 



? [J/nobakJ 



i.e., any 
particular 
explained 


i enclosed in braces indicate a r 
parameter enclosed in braces can 

' command, with different effects 
in accompanying text) . 


equired 
be used 
(which 


H: 


Example: 


.LOAD pcog/AT: (TOP) 
|BTMf 












wheru TOP 


= load prog 
downward. 




rom 


top of 


memory 




BTM 


= load progr 


am frc 




>ttom of 


memory 


This symbol is to be used i 
documents where this symbol is n< 
functional specs) , a set of bt 
enclose the entire list of requii 


n pr inted 
red choices 


manual: 
i (e.g., 
line in 


3. Ir 

drafts, 
height 


Example 


LOAD prog/ AT: {TOP 
BTM} 











accompanying text . 
Example: #LPn:*.*=DKn:* .* 

where n is a unit number (0 



a command str ing 

; supplied by the use 

must be supplied 



UPPER CASE Upper-case 



string, especially in a ba 

Example: .R PIP 

Undecline Characters underlined in an example denote those 

that characters lot underlined constitute computer output. 
[Note: In some cases, for example, editing programs, the 
ratio of user input to machine output may be very high, 
causing readability problems when underlining. In such 
car.es, it is acceptable to underline machine output, but 
that fact must be called out in accompanying text.] 

Example: The command used to kill a page of a file using 

*HK 

Contrasting When a manual is printed in two colors, the color that is 
Colors not used for the textual material is considered the 
contrasting color. In examples, the contrasting color 
denotes those characters that the user entered; the user 
must assume that in an example the information not in the 
contrasting color constitutes computer output. (NOTE: 
When using contrasting colors, do not use the underline 



m.l 
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